Skip to main content

Search Place

Search Place

Search for places and get unique place codes with a session ID. Returns matching places with addresses. Use for business search, landmark lookup, and location selection.

note

Each request generates a new session ID required for Place Details API.

Usage

import { createBarikoiClient } from "barikoiapis";

const barikoi = createBarikoiClient({
apiKey: "YOUR_BARIKOI_API_KEY",
});

const searchResult = await barikoi.searchPlace({ q: "barikoi" });

const sessionId = searchResult.data?.session_id;
const places = searchResult.data?.places || [];

Response

This API returns:

places (array with address, place_code), session_id, status

Parameters

ParameterTypeDescription
qstringRequired. The search query string

Example

const searchResult = await barikoi.searchPlace({ q: "dhaka university" });

const sessionId = searchResult.data?.session_id;
const places = searchResult.data?.places || [];

places.forEach((place) => {
console.log(`${place.address} - Code: ${place.place_code}`);
});

// Use sessionId and place_code for Place Details API
Type Definitions
export type SearchPlaceParams = {
q: string;
};

export type SearchPlaceSuccess = {
places?: Array<{
address?: string;
place_code?: string;
}>;
session_id?: string;
status?: number;
};